home *** CD-ROM | disk | FTP | other *** search
/ Perl Multimedia Cyber Classroom / PERL Multimedia Cyber Classroom (Prentice Hall)(1998).ISO / jre / changes next >
Text File  |  1997-11-24  |  11KB  |  257 lines
  1.                              CHANGES
  2.  
  3.                     Java(tm) Runtime Environment
  4.                           JRE(tm) 1.1.5 
  5.  
  6. -----------------------------------------------------------------------
  7. CONTENTS
  8. -----------------------------------------------------------------------
  9. This document describes the changes made between versions of the JRE. 
  10. The contents of this document are as follows:
  11.  
  12.   - Changes from JRE 1.1.4 to JRE 1.1.5
  13.   - Changes from JRE 1.1.3 to JRE 1.1.4
  14.   - Changes from JRE 1.1.2 to JRE 1.1.3 
  15.   - Changes from JRE 1.1.1 to JRE 1.1.2
  16.  
  17. =======================================================================
  18. CHANGES FROM JRE 1.1.4 TO JRE 1.1.5 
  19. =======================================================================
  20.  
  21. JRE 1.1.5 and JDK 1.1.5 are bug-fix releases. See the JDK CHANGES file 
  22. at http://java.sun.com/products/jdk/1.1/CHANGES or in the JDK software 
  23. download bundle for summaries of significant bugs that are fixed in 
  24. this release of the Java platform.
  25.  
  26.  
  27. =======================================================================
  28. CHANGES FROM JRE 1.1.3 TO JRE 1.1.4 
  29. =======================================================================
  30.  
  31. JRE 1.1.4 and JDK 1.1.4 are bug-fix releases. See the JDK CHANGES file 
  32. at http://java.sun.com/products/jdk/1.1/CHANGES for summaries of 
  33. significant bugs that are fixed in this release.
  34.  
  35. In the JRE README file, the file content-types.properties has been 
  36. moved from the list of OPTIONAL files to the list of REQUIRED files 
  37. because it is required for java.net.
  38.  
  39.  
  40. =======================================================================
  41. CHANGES FROM JRE 1.1.2 TO JRE 1.1.3 
  42. =======================================================================
  43.  
  44. JRE 1.1.3 and JDK 1.1.3 are bug-fix releases. The 1.1.3 release fixes a 
  45. localization bug that prevented characters in text areas of windows 
  46. from displaying properly in non-English language locales and 
  47. non-Western European locales. This problem did not exist in the 1.1.1 
  48. release.
  49.  
  50. See the JDK CHANGES file at 
  51. http://java.sun.com/products/jdk/1.1/CHANGES
  52. for further information about other changes and bug fixes in the 1.1.3  
  53. release.
  54.  
  55. =======================================================================
  56. CHANGES FROM JRE 1.1.1 TO JRE 1.1.2
  57. =======================================================================
  58.  
  59. -----------------------------------------------------------------------
  60. End-User Installation Capability for the Win32 JRE
  61. -----------------------------------------------------------------------
  62.  
  63. When the Win32 JRE 1.1.2 is downloaded, an InstallShield script is 
  64. invoked that automates the installation of the JRE. The feature was not 
  65. present in the 1.1.1 version of the JRE. With the InstallShield script, 
  66. JRE 1.1.2 is suitable for installation by end-users. Because of this 
  67. end-user installation capability of the Win 32 JRE 1.1.2, Java 
  68. application developers have the option of not bundling the JRE with 
  69. their software. Instead, they can direct end-users to download and 
  70. install the JRE themselves.
  71.  
  72. An installer is not available for Solaris versions of the JRE. 
  73. Therefore it is recommended that Solaris application developers write 
  74. their own installers and bundle the JRE and installer with their 
  75. software.
  76.  
  77.  
  78. -----------------------------------------------------------------------
  79. Win32 JRE Available with or without Internationalization Files
  80. -----------------------------------------------------------------------
  81.  
  82. JRE 1.1.2 for Win32 is available for download in two versions, one 
  83. containing internationalization files and the other without. The 
  84. version of the JRE with the internationalization files is more than 
  85. twice the size of the version without the internationalization files. 
  86. The smaller version is made available for those end users who have no 
  87. need for internationalization capability. The files not contained in 
  88. the smaller version of the Win32 JRE are those listed in the OPTIONAL 
  89. FILES section of the JRE README file.
  90.  
  91. Solaris versions of JRE 1.1.2 include internationalization files. 
  92.  
  93.  
  94. -----------------------------------------------------------------------
  95. New jre Tool
  96. -----------------------------------------------------------------------
  97.  
  98. This section provides a summary of the new jre tool for both Win32 and 
  99. Solaris. The jre tool replaces the java tool in JRE 1.1.2. The jre tool 
  100. is similar to the java tool, but offers only those options that are 
  101. appropriate for a runtime-only system. It also provides the -cp and 
  102. -nojit options that are not part of the java tool. More detailed 
  103. documentation for the jre tool can be found on the JavaSoft web site 
  104. at:
  105.  
  106. For Solaris - 
  107. http://java.sun.com/products/jdk/1.1/docs/tooldocs/solaris/jre.html
  108.  
  109. For Windows - 
  110. http://java.sun.com/products/jdk/1.1/docs/tooldocs/win32/jre.html
  111.  
  112. Source code for the jre tool can be found in the Windows JDK 1.1.2 
  113. directory tree in the jdk1.1.2\demo\jre\win32 folder. For the 
  114. Solaris JDK 1.1.2, source code for the jre tool can be found in 
  115. the jdk1.1.2/demo/jre/solaris directory.
  116.  
  117. The jre tool invokes the Java Runtime interpreter for executing Java 
  118. applications. The tool is available in the Win32, Solaris-Sparc, and 
  119. Solaris x86 downloads of JRE 1.1.2. The syntax for the jre command is:
  120.  
  121.     jre [ options ] classname <args>
  122.  
  123. The classname argument is the name of the class file to be 
  124. executed. Any arguments to be passed to the class must be placed 
  125. after the classname on the command line.
  126.  
  127. An alternative version of the tool, jrew, is available for Win32. The 
  128. jrew command is identical to jre, except that a console window is not 
  129. invoked. The syntax of the jrew command is 
  130.  
  131.     jrew [ options ] classname <args>
  132.  
  133. On Windows platforms, the jre tool will ignore the CLASSPATH 
  134. environment variable. For both Windows and Solaris platforms, the 
  135. -cp option is recommended to specify an application's class path.
  136.  
  137. Options for the jre and the jrew commands are as follows:
  138.  
  139.    -classpath path    Specifies the path that jre uses to 
  140.                look up classes. Overrides the default 
  141.                classpath.  
  142.  
  143.    -cp path        Prepends the specified path to the default 
  144.                classpath that jre uses to look up classes. 
  145.  
  146.    -help        Print a usage message.
  147.  
  148.    -mx x        Sets the maximum size of the memory allocation 
  149.                pool (the garbage collected heap) to x. The 
  150.                default is 16 megabytes of memory. x must be
  151.             greater than or equal to 1000 bytes.
  152.  
  153.    -ms x        Sets the startup size of the memory allocation 
  154.                pool (the garbage collected heap) to x. The 
  155.                default is 1 megabyte of memory. x must be
  156.             greater than 1000 bytes.
  157.  
  158.    -noasyncgc        Turns off asynchronous garbage collection. When 
  159.                activated, no garbage collection takes place 
  160.                unless it is explicitly called or the program 
  161.             runs out of memory.
  162.  
  163.    -noclassgc        Turns off garbage collection of Java classes. 
  164.                By default, the Java interpreter reclaims space 
  165.                for unused Java classes during garbage collection.
  166.  
  167.    -nojit        Specifies that any JIT compiler should be 
  168.             ignored. The default Java interpreter is invoked.
  169.  
  170.    -ss x        The -ss option sets the maximum stack size that 
  171.                can be used by C code in a thread to x. The 
  172.             default units for x are bytes. The value of x 
  173.             must be greater than or equal to 1000 bytes.
  174.  
  175.    -oss x        The -oss option sets the maximum stack size 
  176.             that can be used by Java code in a thread to x. 
  177.             The default units for x are bytes. The value of 
  178.             x must be greater than or equal to 1000 bytes.
  179.  
  180.    -v, -verbose        Causes jre to print a message to stdout each 
  181.             time a class file is loaded.
  182.  
  183.    -verify        Performs byte-code verification on the class 
  184.             file. Beware, however, that java -verify does 
  185.             not perform a full verification in all 
  186.             situations. Any code path that is not actually 
  187.             executed by the interpreter is not verified. 
  188.             Therefore, java -verify cannot be relied upon to 
  189.             certify class files unless all code paths in 
  190.             the class file are actually run.
  191.  
  192.    -verifyremote    Runs the verifier on all code that is loaded 
  193.             into the system via a classloader. verifyremote 
  194.             is the default for the interpreter.
  195.  
  196.    -noverify        Turns verification off.
  197.  
  198.    -verbosegc        Causes the garbage collector to print out 
  199.             messages whenever it frees memory.
  200.    
  201.    -DpropName=value    Defines a property value. propName is the name 
  202.             of the property whose value you want to change 
  203.             and value is the value to change it to. For 
  204.             example, the command 
  205.             java -Dawt.button.color=green ...
  206.             sets the value of the property awt.button.color 
  207.             to "green".
  208.  
  209.  
  210. -----------------------------------------------------------------------
  211. Early-Access Release of the JRE for Solaris-x86
  212. -----------------------------------------------------------------------
  213.  
  214. An early-access release of JRE 1.1.2 for Solaris x86 is available for 
  215. download.  An FCS version of the JRE for Solaris x86 will be made 
  216. available in the future.
  217.  
  218. BECAUSE THE JRE 1.1.2 FOR SOLARIS x86 IS AN EARLY-ACCESS RELEASE ONLY,
  219. IT SHOULD NOT BE USED FOR MISSION-CRITICAL APPLICATIONS.
  220.  
  221.  
  222. -----------------------------------------------------------------------
  223. JNI Invocation API Changes
  224. -----------------------------------------------------------------------
  225.  
  226. To better support the JRE, the Invocation API is extended in JDK 1.1.2 
  227. in a few minor ways. The changes do not break any existing code. The 
  228. JNI Native Method Interface has not been changed. 
  229.  
  230. 1. The reserved0 field in the JDK1_1InitArgs structure has been
  231. renamed to "version." The JDK1_1InitArgs structure holds the
  232. initialization arguments to JNI_CreateJavaVM. Callers of 
  233. JNI_CreateJavaVM must set the version field to 0x00010001. 
  234. JNI_GetDefaultJavaVMInitArgs has been changed to return a "jint" 
  235. indicating whether the requested version is supported.
  236.  
  237. 2. The reserved1 field in the JDK1_1InitArgs structure has been
  238. renamed to "properties." This is a NULL-terminated array of 
  239. strings. Each string has the format:
  240.  
  241.             name=value
  242.  
  243. indicating a system property. (This facility corresponds to the -D
  244. option in the java command line.)
  245.  
  246. 3. In JDK 1.1.1, the thread calling DestroyJavaVM must be the only
  247. user thread in the VM. JDK 1.1.2 has lifted this restriction. If
  248. DestroyJavaVM is called when there is more than one user thread,
  249. the VM waits until the current thread is the only user thread, and
  250. then tries to destroy itself.
  251.  
  252.  
  253. -----------------------------------------------------------------------
  254. Copyright ⌐ 1997 Sun Microsystems, Inc.
  255. 901 San Antonio Road, Palo Alto, CA 94303-4900 USA
  256. All rights reserved.
  257.